<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  
  <meta http-equiv="X-UA-Compatible" content="IE=edge" >
  <title>构建 NetworkExtension 应用（二） | Grx Blog</title>
  <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
  <meta name="description" content="之前介绍了关于科学上网的一些知识，这章会先介绍下 NetworkExtension，以及相关的一些 iOS 平台的开源项目。最后再开始我们自己的项目。实际上，我们自己的 NetworkExtension 应用，其实就是扮演 SS-Local 的角色。">
<meta property="og:type" content="article">
<meta property="og:title" content="构建 NetworkExtension 应用（二）">
<meta property="og:url" content="http://yoursite.com/2019/07/20/构建 NetworkExtension 应用（二）/index.html">
<meta property="og:site_name" content="Grx Blog">
<meta property="og:description" content="之前介绍了关于科学上网的一些知识，这章会先介绍下 NetworkExtension，以及相关的一些 iOS 平台的开源项目。最后再开始我们自己的项目。实际上，我们自己的 NetworkExtension 应用，其实就是扮演 SS-Local 的角色。">
<meta property="og:image" content="https://lettleprince.github.io/images/20171115-NetworkExtension/01.png">
<meta property="og:image" content="https://lettleprince.github.io/images/20171115-NetworkExtension/02.png">
<meta property="og:image" content="https://lettleprince.github.io/images/20171113-NetworkExtension/whats-shadowsocks-03.png">
<meta property="og:image" content="https://lettleprince.github.io/images/20171115-NetworkExtension/03.png">
<meta property="og:image" content="https://lettleprince.github.io/images/20171115-NetworkExtension/04.png">
<meta property="og:updated_time" content="2019-07-22T10:21:35.755Z">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="构建 NetworkExtension 应用（二）">
<meta name="twitter:description" content="之前介绍了关于科学上网的一些知识，这章会先介绍下 NetworkExtension，以及相关的一些 iOS 平台的开源项目。最后再开始我们自己的项目。实际上，我们自己的 NetworkExtension 应用，其实就是扮演 SS-Local 的角色。">
<meta name="twitter:image" content="https://lettleprince.github.io/images/20171115-NetworkExtension/01.png">
  
    <link rel="alternative" href="/atom.xml" title="Grx Blog" type="application/atom+xml">
  
  
    <link rel="icon" href="/favicon.png">
  
  <link rel="stylesheet" href="/css/style.css">
</head>

<body>
  <div id="container">
    <div class="left-col">
    <div class="overlay"></div>
<div class="intrude-less">
	<header id="header" class="inner">
		<a href="/" class="profilepic">
			
			<img lazy-src="/img/rufei.jpg" class="js-avatar">
			
		</a>

		<hgroup>
		  <h1 class="header-author"><a href="/">Grx</a></h1>
		</hgroup>

		
		<p class="header-subtitle">自我管理，知识管理，时间管理，阅读，语音写作，思维导图</p>
		

		
			<div class="switch-btn">
				<div class="icon">
					<div class="icon-ctn">
						<div class="icon-wrap icon-house" data-idx="0">
							<div class="birdhouse"></div>
							<div class="birdhouse_holes"></div>
						</div>
						<div class="icon-wrap icon-ribbon hide" data-idx="1">
							<div class="ribbon"></div>
						</div>
						
						<div class="icon-wrap icon-link hide" data-idx="2">
							<div class="loopback_l"></div>
							<div class="loopback_r"></div>
						</div>
						
						
						<div class="icon-wrap icon-me hide" data-idx="3">
							<div class="user"></div>
							<div class="shoulder"></div>
						</div>
						
					</div>
					
				</div>
				<div class="tips-box hide">
					<div class="tips-arrow"></div>
					<ul class="tips-inner">
						<li>菜单</li>
						<li>标签</li>
						
						<li>友情链接</li>
						
						
						<li>关于我</li>
						
					</ul>
				</div>
			</div>
		

		<div class="switch-area">
			<div class="switch-wrap">
				<section class="switch-part switch-part1">
					<nav class="header-menu">
						<ul>
						
							<li><a href="/">主页</a></li>
				        
							<li><a href="/tags/life">随笔</a></li>
				        
							<li><a href="/archives">所有文章</a></li>
				        
						</ul>
					</nav>
					<nav class="header-nav">
						<div class="social">
							
								<a class="github" target="_blank" href="https://github.com/ruixiaoguo" title="github">github</a>
					        
								<a class="weibo" target="_blank" href="https://weibo.com/u/3984935859?refer_flag=1005055010_" title="weibo">weibo</a>
					        
								<a class="rss" target="_blank" href="#" title="rss">rss</a>
					        
								<a class="zhihu" target="_blank" href="#" title="zhihu">zhihu</a>
					        
						</div>
					</nav>
				</section>
				
				
				<section class="switch-part switch-part2">
					<div class="widget tagcloud" id="js-tagcloud">
						<a href="/tags/OC/" style="font-size: 10px;">-OC</a> <a href="/tags/Android/" style="font-size: 10px;">Android</a> <a href="/tags/Apple-Watch/" style="font-size: 10px;">Apple Watch</a> <a href="/tags/Flutter/" style="font-size: 13.33px;">Flutter</a> <a href="/tags/Life/" style="font-size: 10px;">Life</a> <a href="/tags/Lottie/" style="font-size: 10px;">Lottie</a> <a href="/tags/MMKV/" style="font-size: 10px;">MMKV</a> <a href="/tags/MonkeyKing/" style="font-size: 10px;">MonkeyKing</a> <a href="/tags/OC/" style="font-size: 20px;">OC</a> <a href="/tags/RAC/" style="font-size: 11.67px;">RAC</a> <a href="/tags/Swift/" style="font-size: 15px;">Swift</a> <a href="/tags/WKWebView/" style="font-size: 10px;">WKWebView</a> <a href="/tags/WebView/" style="font-size: 10px;">WebView</a> <a href="/tags/Xcode/" style="font-size: 18.33px;">Xcode</a> <a href="/tags/appledoc/" style="font-size: 10px;">appledoc</a> <a href="/tags/hexo/" style="font-size: 11.67px;">hexo</a> <a href="/tags/ios/" style="font-size: 10px;">ios</a> <a href="/tags/life/" style="font-size: 16.67px;">life</a> <a href="/tags/xcode/" style="font-size: 10px;">xcode</a>
					</div>
				</section>
				
				
				
				<section class="switch-part switch-part3">
					<div id="js-friends">
					
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://blog.devtang.com">唐巧的博客</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://beyondvincent.com">破船之家</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://limboy.me">无网不剩</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://msching.github.io">码农人生</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://yulingtianxia.com">玉令天下</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://blog.leichunfeng.com">雷纯锋的技术博客</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://jax.cnblogs.com">包建强</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://blog.cnbang.net">bang</a>
			        
			        </div>
				</section>
				

				
				
				<section class="switch-part switch-part4">
				
					<div id="js-aboutme">知识管理，时间管理，自我管理，阅读，语音写作，思维导图，Wiz，TimeMeter</div>
				</section>
				
			</div>
		</div>
	</header>				
</div>

    </div>
    <div class="mid-col">
      <nav id="mobile-nav">
  	<div class="overlay">
  		<div class="slider-trigger"></div>
  		<h1 class="header-author js-mobile-header hide">Grx</h1>
  	</div>
	<div class="intrude-less">
		<header id="header" class="inner">
			<div class="profilepic">
			
				<img lazy-src="/img/rufei.jpg" class="js-avatar">
			
			</div>
			<hgroup>
			  <h1 class="header-author">Grx</h1>
			</hgroup>
			
			<p class="header-subtitle">自我管理，知识管理，时间管理，阅读，语音写作，思维导图</p>
			
			<nav class="header-menu">
				<ul>
				
					<li><a href="/">主页</a></li>
		        
					<li><a href="/tags/life">随笔</a></li>
		        
					<li><a href="/archives">所有文章</a></li>
		        
		        <div class="clearfix"></div>
				</ul>
			</nav>
			<nav class="header-nav">
				<div class="social">
					
						<a class="github" target="_blank" href="https://github.com/ruixiaoguo" title="github">github</a>
			        
						<a class="weibo" target="_blank" href="https://weibo.com/u/3984935859?refer_flag=1005055010_" title="weibo">weibo</a>
			        
						<a class="rss" target="_blank" href="#" title="rss">rss</a>
			        
						<a class="zhihu" target="_blank" href="#" title="zhihu">zhihu</a>
			        
				</div>
			</nav>
		</header>				
	</div>
</nav>

      <div class="body-wrap"><article id="post-构建 NetworkExtension 应用（二）" class="article article-type-post" itemscope itemprop="blogPost">
  
    <div class="article-meta">
      <a href="/2019/07/20/构建 NetworkExtension 应用（二）/" class="article-date">
  	<time datetime="2019-07-20T09:28:47.000Z" itemprop="datePublished">2019-07-20</time>
</a>
    </div>
  
  <div class="article-inner">
    
      <input type="hidden" class="isFancy" />
    
    
      <header class="article-header">
        
  
    <h1 class="article-title" itemprop="name">
      构建 NetworkExtension 应用（二）
    </h1>
  

      </header>
      
      <div class="article-info article-info-post">
        
	<div class="article-tag tagcloud">
		<ul class="article-tag-list"><li class="article-tag-list-item"><a class="article-tag-list-link" href="/tags/Xcode/">Xcode</a></li></ul>
	</div>

        

        <div class="clearfix"></div>
      </div>
      
    
    <div class="article-entry" itemprop="articleBody">
      
        <blockquote>
<h4 id="之前介绍了关于科学上网的一些知识，这章会先介绍下-NetworkExtension，以及相关的一些-iOS-平台的开源项目。最后再开始我们自己的项目。实际上，我们自己的-NetworkExtension-应用，其实就是扮演-SS-Local-的角色。"><a href="#之前介绍了关于科学上网的一些知识，这章会先介绍下-NetworkExtension，以及相关的一些-iOS-平台的开源项目。最后再开始我们自己的项目。实际上，我们自己的-NetworkExtension-应用，其实就是扮演-SS-Local-的角色。" class="headerlink" title="之前介绍了关于科学上网的一些知识，这章会先介绍下 NetworkExtension，以及相关的一些 iOS 平台的开源项目。最后再开始我们自己的项目。实际上，我们自己的 NetworkExtension 应用，其实就是扮演 SS-Local 的角色。"></a>之前介绍了关于科学上网的一些知识，这章会先介绍下 NetworkExtension，以及相关的一些 iOS 平台的开源项目。最后再开始我们自己的项目。实际上，我们自己的 NetworkExtension 应用，其实就是扮演 SS-Local 的角色。</h4></blockquote>
<a id="more"></a>
<h2 id="一-NetworkExtension-相关："><a href="#一-NetworkExtension-相关：" class="headerlink" title="一.   NetworkExtension 相关："></a>一.   NetworkExtension 相关：</h2><h3 id="NetworkExtension是苹果提供的用于配置-VPN-和定制、扩展核心网络功能的框架。NE-框架提供了可用于定制、扩展-iOS-和-MacOS-系统的核心网络功能的-API。"><a href="#NetworkExtension是苹果提供的用于配置-VPN-和定制、扩展核心网络功能的框架。NE-框架提供了可用于定制、扩展-iOS-和-MacOS-系统的核心网络功能的-API。" class="headerlink" title="NetworkExtension是苹果提供的用于配置 VPN 和定制、扩展核心网络功能的框架。NE 框架提供了可用于定制、扩展 iOS 和 MacOS 系统的核心网络功能的 API。"></a><a href="https://developer.apple.com/documentation/networkextension" target="_blank" rel="external">NetworkExtension</a>是苹果提供的用于配置 VPN 和定制、扩展核心网络功能的框架。NE 框架提供了可用于定制、扩展 iOS 和 MacOS 系统的核心网络功能的 API。</h3><h3 id="Network-Extension-最早出现在-iOS-8，不过那个版本不支持虚拟网卡，只能简单调用-iOS-系统自带的-IPSec-和-IKEv2-协议的-VPN。在-iOS-9-中，开发者可以用-NETunnelProvider-扩展核心网络层，从而实现非标准化的私密VPN技术。最重要的两个类是-NETunnelProviderManager-和-NEPacketTunnelProvider。"><a href="#Network-Extension-最早出现在-iOS-8，不过那个版本不支持虚拟网卡，只能简单调用-iOS-系统自带的-IPSec-和-IKEv2-协议的-VPN。在-iOS-9-中，开发者可以用-NETunnelProvider-扩展核心网络层，从而实现非标准化的私密VPN技术。最重要的两个类是-NETunnelProviderManager-和-NEPacketTunnelProvider。" class="headerlink" title="Network Extension 最早出现在 iOS 8，不过那个版本不支持虚拟网卡，只能简单调用 iOS 系统自带的 IPSec 和 IKEv2 协议的 VPN。在 iOS 9 中，开发者可以用 NETunnelProvider 扩展核心网络层，从而实现非标准化的私密VPN技术。最重要的两个类是 NETunnelProviderManager 和 NEPacketTunnelProvider。"></a>Network Extension 最早出现在 iOS 8，不过那个版本不支持虚拟网卡，只能简单调用 iOS 系统自带的 IPSec 和 IKEv2 协议的 VPN。在 iOS 9 中，开发者可以用 NETunnelProvider 扩展核心网络层，从而实现非标准化的私密VPN技术。最重要的两个类是 NETunnelProviderManager 和 NEPacketTunnelProvider。</h3><h3 id="Potatso-便是使用-NE-框架实现了-Shadowsocks-代理，遗憾的是由于种种原因作者删除了开源代码。GitHub-上有不少人维护了其分支，但也都更新很慢，最近发现的一个可运行版本是这个，但我之前升级了-Xcode-9，所以也要进行一系列改动。最后终于改出一个可在-Xcode-9-上编译运行的版本，但是也并没有改动的很完美。大家凑合学习吧。"><a href="#Potatso-便是使用-NE-框架实现了-Shadowsocks-代理，遗憾的是由于种种原因作者删除了开源代码。GitHub-上有不少人维护了其分支，但也都更新很慢，最近发现的一个可运行版本是这个，但我之前升级了-Xcode-9，所以也要进行一系列改动。最后终于改出一个可在-Xcode-9-上编译运行的版本，但是也并没有改动的很完美。大家凑合学习吧。" class="headerlink" title="Potatso 便是使用 NE 框架实现了 Shadowsocks 代理，遗憾的是由于种种原因作者删除了开源代码。GitHub 上有不少人维护了其分支，但也都更新很慢，最近发现的一个可运行版本是这个，但我之前升级了 Xcode 9，所以也要进行一系列改动。最后终于改出一个可在 Xcode 9 上编译运行的版本，但是也并没有改动的很完美。大家凑合学习吧。"></a><a href="https://github.com/Potatso/Potatso" target="_blank" rel="external">Potatso</a> 便是使用 NE 框架实现了 Shadowsocks 代理，遗憾的是由于种种原因作者删除了开源代码。GitHub 上有不少人维护了其分支，但也都更新很慢，最近发现的一个可运行版本是这个，但我之前升级了 Xcode 9，所以也要进行一系列改动。最后终于改出一个可在 Xcode 9 上编译运行的版本，但是也并没有改动的很完美。大家凑合学习吧。</h3><h2 id="二-NEKit-相关"><a href="#二-NEKit-相关" class="headerlink" title="二.NEKit 相关"></a>二.NEKit 相关</h2><h3 id="通过-Potatso-学习-Network-Extension，对于初学者来说不太友好，毕竟项目很久不维护了。还有个更简单的方案，这要多亏了-NEKit-框架。NEKit-甚至可以不依赖-Network-Extension-framework（当然我们构建的项目是需要的）。有个-demo-可以看下。"><a href="#通过-Potatso-学习-Network-Extension，对于初学者来说不太友好，毕竟项目很久不维护了。还有个更简单的方案，这要多亏了-NEKit-框架。NEKit-甚至可以不依赖-Network-Extension-framework（当然我们构建的项目是需要的）。有个-demo-可以看下。" class="headerlink" title="通过 Potatso 学习 Network Extension，对于初学者来说不太友好，毕竟项目很久不维护了。还有个更简单的方案，这要多亏了 NEKit 框架。NEKit 甚至可以不依赖 Network Extension framework（当然我们构建的项目是需要的）。有个 demo 可以看下。"></a>通过 Potatso 学习 Network Extension，对于初学者来说不太友好，毕竟项目很久不维护了。还有个更简单的方案，这要多亏了 NEKit 框架。NEKit 甚至可以不依赖 Network Extension framework（当然我们构建的项目是需要的）。有个 <a href="https://github.com/yichengchen/RabbitVpnDemo" target="_blank" rel="external">demo</a> 可以看下。</h3><h2 id="三-初始化项目"><a href="#三-初始化项目" class="headerlink" title="三.初始化项目"></a>三.初始化项目</h2><h3 id="新建项目"><a href="#新建项目" class="headerlink" title="新建项目"></a>新建项目</h3><h3 id="建立普通-Swift-项目-QLadder-此项目后来也将作为我们-iOS-部门内部翻墙用的客户端，所以用了企业证书-。"><a href="#建立普通-Swift-项目-QLadder-此项目后来也将作为我们-iOS-部门内部翻墙用的客户端，所以用了企业证书-。" class="headerlink" title="建立普通 Swift 项目 QLadder(此项目后来也将作为我们 iOS 部门内部翻墙用的客户端，所以用了企业证书)。"></a>建立普通 Swift 项目 QLadder(此项目后来也将作为我们 iOS 部门内部翻墙用的客户端，所以用了企业证书)。</h3><h3 id="项目支持的最低-iOS-版本是-9-3，因为之前我改过一次-9-0，会有问题。"><a href="#项目支持的最低-iOS-版本是-9-3，因为之前我改过一次-9-0，会有问题。" class="headerlink" title="项目支持的最低 iOS 版本是 9.3，因为之前我改过一次 9.0，会有问题。"></a>项目支持的最低 iOS 版本是 9.3，因为之前我改过一次 9.0，会有问题。</h3><h3 id="还有，Network-Extension-无法在模拟器上调试。同时，你得有开发者账号，用来申请相关-Capabilities。"><a href="#还有，Network-Extension-无法在模拟器上调试。同时，你得有开发者账号，用来申请相关-Capabilities。" class="headerlink" title="还有，Network Extension 无法在模拟器上调试。同时，你得有开发者账号，用来申请相关 Capabilities。"></a>还有，Network Extension 无法在模拟器上调试。同时，你得有开发者账号，用来申请相关 Capabilities。</h3><h3 id="新建-PacketTunnel"><a href="#新建-PacketTunnel" class="headerlink" title="新建 PacketTunnel"></a>新建 PacketTunnel</h3><h3 id="新建-Target，选择-Network-Extension。"><a href="#新建-Target，选择-Network-Extension。" class="headerlink" title="新建 Target，选择 Network Extension。"></a>新建 Target，选择 Network Extension。</h3><p><img src="https://lettleprince.github.io/images/20171115-NetworkExtension/01.png" alt="avatar"></p>
<h3 id="然后选择-Provider-Type-为-PacketTunnel。"><a href="#然后选择-Provider-Type-为-PacketTunnel。" class="headerlink" title="然后选择 Provider Type 为 PacketTunnel。"></a>然后选择 Provider Type 为 PacketTunnel。</h3><p><img src="https://lettleprince.github.io/images/20171115-NetworkExtension/02.png" alt="avatar"></p>
<h3 id="翻越-GFW-比直接的方案就是：墙外有一台不受限制的服务器，我们要请求或发送的数据通过这台服务器进行中转，这就需要我们通过加密来保证与墙外服务器通讯时不被-GFW-怀疑和窃听。比较常用的技术有：HTTP-代理服务、Socks-服务、VPN-服务等，其中以-SSH-tunnel-的方法比较有代表性。"><a href="#翻越-GFW-比直接的方案就是：墙外有一台不受限制的服务器，我们要请求或发送的数据通过这台服务器进行中转，这就需要我们通过加密来保证与墙外服务器通讯时不被-GFW-怀疑和窃听。比较常用的技术有：HTTP-代理服务、Socks-服务、VPN-服务等，其中以-SSH-tunnel-的方法比较有代表性。" class="headerlink" title="翻越 GFW 比直接的方案就是：墙外有一台不受限制的服务器，我们要请求或发送的数据通过这台服务器进行中转，这就需要我们通过加密来保证与墙外服务器通讯时不被 GFW 怀疑和窃听。比较常用的技术有：HTTP 代理服务、Socks 服务、VPN 服务等，其中以 SSH tunnel 的方法比较有代表性。"></a>翻越 GFW 比直接的方案就是：墙外有一台不受限制的服务器，我们要请求或发送的数据通过这台服务器进行中转，这就需要我们通过加密来保证与墙外服务器通讯时不被 GFW 怀疑和窃听。比较常用的技术有：HTTP 代理服务、Socks 服务、VPN 服务等，其中以 SSH tunnel 的方法比较有代表性。</h3><p><img src="https://lettleprince.github.io/images/20171113-NetworkExtension/whats-shadowsocks-03.png" alt="avatar"></p>
<h3 id="申请-entitlements"><a href="#申请-entitlements" class="headerlink" title="申请 entitlements"></a>申请 entitlements</h3><h3 id="如果-containing-app-要与-extension-共享数据，则必须要开启-App-Groups。"><a href="#如果-containing-app-要与-extension-共享数据，则必须要开启-App-Groups。" class="headerlink" title="如果 containing app 要与 extension 共享数据，则必须要开启 App Groups。"></a>如果 containing app 要与 extension 共享数据，则必须要开启 App Groups。</h3><h3 id="Personal-VPN-和-Network-Extensions（App-Proxy、Content-Filter、Packet-Tunnel）也当然要开启。"><a href="#Personal-VPN-和-Network-Extensions（App-Proxy、Content-Filter、Packet-Tunnel）也当然要开启。" class="headerlink" title="Personal VPN 和 Network Extensions（App Proxy、Content Filter、Packet Tunnel）也当然要开启。"></a>Personal VPN 和 Network Extensions（App Proxy、Content Filter、Packet Tunnel）也当然要开启。</h3><h3 id="第三方框架"><a href="#第三方框架" class="headerlink" title="第三方框架"></a>第三方框架</h3><h3 id="NEKit-推荐将项目拖入工程，或者使用-Carthage-集成。"><a href="#NEKit-推荐将项目拖入工程，或者使用-Carthage-集成。" class="headerlink" title="NEKit 推荐将项目拖入工程，或者使用 Carthage 集成。"></a>NEKit 推荐将项目拖入工程，或者使用 Carthage 集成。</h3><h3 id="其他的第三方框架使用-Pod："><a href="#其他的第三方框架使用-Pod：" class="headerlink" title="其他的第三方框架使用 Pod："></a>其他的第三方框架使用 Pod：</h3><ul>
<li>SwiftColor</li>
<li>CocoaLumberjack/Swift</li>
<li>Alamofire</li>
</ul>
<h2 id="四-代码"><a href="#四-代码" class="headerlink" title="四.代码"></a>四.代码</h2><h3 id="NETunnelProviderManager"><a href="#NETunnelProviderManager" class="headerlink" title="NETunnelProviderManager"></a>NETunnelProviderManager</h3><h3 id="上面提到了两个核心类，其中一个是，NETunnelProviderManager，它和-vpn-设置是一一对应关系。如果-App-有两个-vpn-设置，我们通过代码就能得到两个-NETunnelProviderManager-实例。我们要通过代码，对-NETunnelProviderManager-做四种操作。"><a href="#上面提到了两个核心类，其中一个是，NETunnelProviderManager，它和-vpn-设置是一一对应关系。如果-App-有两个-vpn-设置，我们通过代码就能得到两个-NETunnelProviderManager-实例。我们要通过代码，对-NETunnelProviderManager-做四种操作。" class="headerlink" title="上面提到了两个核心类，其中一个是，NETunnelProviderManager，它和 vpn 设置是一一对应关系。如果 App 有两个 vpn 设置，我们通过代码就能得到两个 NETunnelProviderManager 实例。我们要通过代码，对 NETunnelProviderManager 做四种操作。"></a>上面提到了两个核心类，其中一个是，NETunnelProviderManager，它和 vpn 设置是一一对应关系。如果 App 有两个 vpn 设置，我们通过代码就能得到两个 NETunnelProviderManager 实例。我们要通过代码，对 NETunnelProviderManager 做四种操作。</h3><h3 id="1-创建-vpn-配置。"><a href="#1-创建-vpn-配置。" class="headerlink" title="1.创建 vpn 配置。"></a>1.创建 vpn 配置。</h3><pre><code>fileprivate func createProviderManager() -&gt; NETunnelProviderManager {
   let manager = NETunnelProviderManager()
   manager.protocolConfiguration = NETunnelProviderProtocol()
   return manager
</code></pre><p>}</p>
<h3 id="2-保存-vpn-配置"><a href="#2-保存-vpn-配置" class="headerlink" title="2.保存 vpn 配置"></a>2.保存 vpn 配置</h3><pre><code>manager.saveToPreferences {
    if let error = $0 {
        complete(nil, error)
    } else {
        manager.loadFromPreferences(completionHandler: { (error) -&gt; Void in
            if let error = error {
                complete(nil, error)
            } else {
                complete(manager, nil)
            }
        })
    }
} 
</code></pre><h3 id="这段代码执行时会请求用户的授权，允许之后会添加一份-vpn-的配置。"><a href="#这段代码执行时会请求用户的授权，允许之后会添加一份-vpn-的配置。" class="headerlink" title="这段代码执行时会请求用户的授权，允许之后会添加一份 vpn 的配置。"></a>这段代码执行时会请求用户的授权，允许之后会添加一份 vpn 的配置。</h3><h3 id="3-开启和关闭-vpn"><a href="#3-开启和关闭-vpn" class="headerlink" title="3.开启和关闭 vpn"></a>3.开启和关闭 vpn</h3><pre><code>   fileprivate func startVPNWithOptions(_ options: [String : NSObject]?, complete: ((NETunnelProviderManager?, Error?) -&gt; Void)? = nil) {
    // Load provider
    loadAndCreateProviderManager { (manager, error) -&gt; Void in
        if let error = error {
            complete?(nil, error)
        } else {
            guard let manager = manager else {
                complete?(nil, ManagerError.invalidProvider)
                return
            }
            if manager.connection.status == .disconnected || manager.connection.status == .invalid {
                do {
                    try manager.connection.startVPNTunnel(options: options)
                    self.addVPNStatusObserver()
                    complete?(manager, nil)
                }catch {
                    complete?(nil, error)
                }
            } else {
                self.addVPNStatusObserver()
                complete?(manager, nil)
            }
        }
    }
}

public func stopVPN() {
    // Stop provider
    loadProviderManager {
        guard let manager = $0 else {
            return
        }
        manager.connection.stopVPNTunnel()
    }
}
</code></pre><h3 id="4-监听并更新-vpn-状态"><a href="#4-监听并更新-vpn-状态" class="headerlink" title="4.监听并更新 vpn 状态"></a>4.监听并更新 vpn 状态</h3><pre><code>/// 添加vpn的状态的监听
func addVPNStatusObserver() {
    guard !observerDidAdd else {
        return
    }
    loadProviderManager {
        if let manager = $0 {
            self.observerDidAdd = true
            NotificationCenter.default.addObserver(forName: NSNotification.Name.NEVPNStatusDidChange, object: manager.connection, queue: OperationQueue.main, using: { [unowned self] (notification) -&gt; Void in
                self.updateVPNStatus(manager)
            })
        }
    }
}

/// 更新vpn的连接状态
///
/// - Parameter manager: NEVPNManager
func updateVPNStatus(_ manager: NEVPNManager) {

    switch manager.connection.status {
    case .connected:
        self.vpnStatus = .on
    case .connecting, .reasserting:
        self.vpnStatus = .connecting
    case .disconnecting:
        self.vpnStatus = .disconnecting
    case .disconnected, .invalid:
        self.vpnStatus = .off
    }
}
</code></pre><h3 id="NEPacketTunnelProvider"><a href="#NEPacketTunnelProvider" class="headerlink" title="NEPacketTunnelProvider"></a>NEPacketTunnelProvider</h3><h3 id="NEPacketTunnelProvider，是真正的-vpn-核心代码。项目中-PacketTunnelProvider-是其子类，并且以下两个方法必须实现。"><a href="#NEPacketTunnelProvider，是真正的-vpn-核心代码。项目中-PacketTunnelProvider-是其子类，并且以下两个方法必须实现。" class="headerlink" title="NEPacketTunnelProvider，是真正的 vpn 核心代码。项目中 PacketTunnelProvider 是其子类，并且以下两个方法必须实现。"></a>NEPacketTunnelProvider，是真正的 vpn 核心代码。项目中 PacketTunnelProvider 是其子类，并且以下两个方法必须实现。</h3><pre><code>@available(iOS 9.0, *)
open func startTunnel(options: [String : NSObject]? = nil, completionHandler: @escaping (Error?) -&gt; Swift.Void)

@available(iOS 9.0, *)
open func stopTunnel(with reason: NEProviderStopReason, completionHandler: @escaping () -&gt; Swift.Void)
</code></pre><h3 id="当-App-里的-NETunnelProviderManager-对象调用-startVPNWithOptions-时，控制流程就跳到-Extension-里的-startTunnel-方法。"><a href="#当-App-里的-NETunnelProviderManager-对象调用-startVPNWithOptions-时，控制流程就跳到-Extension-里的-startTunnel-方法。" class="headerlink" title="当 App 里的 NETunnelProviderManager 对象调用 startVPNWithOptions 时，控制流程就跳到 Extension 里的 startTunnel 方法。"></a>当 App 里的 NETunnelProviderManager 对象调用 startVPNWithOptions 时，控制流程就跳到 Extension 里的 startTunnel 方法。</h3><h3 id="startTunnel-有两个参数：options-是个字典，从-App-里传过来，具体有啥信息完全由开发者自己定义。completionHandler-是个闭包回调，由系统提供。我们可以将其保存到某个变量，待-vpn-启动完成时主动调用。"><a href="#startTunnel-有两个参数：options-是个字典，从-App-里传过来，具体有啥信息完全由开发者自己定义。completionHandler-是个闭包回调，由系统提供。我们可以将其保存到某个变量，待-vpn-启动完成时主动调用。" class="headerlink" title="startTunnel 有两个参数：options 是个字典，从 App 里传过来，具体有啥信息完全由开发者自己定义。completionHandler 是个闭包回调，由系统提供。我们可以将其保存到某个变量，待 vpn 启动完成时主动调用。"></a>startTunnel 有两个参数：options 是个字典，从 App 里传过来，具体有啥信息完全由开发者自己定义。completionHandler 是个闭包回调，由系统提供。我们可以将其保存到某个变量，待 vpn 启动完成时主动调用。</h3><h3 id="stopTunnel-也有两个参数：reason-表示-vpn-被关闭的理由。iOS-预先定义了一组-NEProviderStopReason-常数，但实际应用时，reason-基本不用。completionHandler-的用法同-startTunnel-第二个参数一样，不再重复。"><a href="#stopTunnel-也有两个参数：reason-表示-vpn-被关闭的理由。iOS-预先定义了一组-NEProviderStopReason-常数，但实际应用时，reason-基本不用。completionHandler-的用法同-startTunnel-第二个参数一样，不再重复。" class="headerlink" title="stopTunnel 也有两个参数：reason 表示 vpn 被关闭的理由。iOS 预先定义了一组 NEProviderStopReason 常数，但实际应用时，reason 基本不用。completionHandler 的用法同 startTunnel 第二个参数一样，不再重复。"></a>stopTunnel 也有两个参数：reason 表示 vpn 被关闭的理由。iOS 预先定义了一组 NEProviderStopReason 常数，但实际应用时，reason 基本不用。completionHandler 的用法同 startTunnel 第二个参数一样，不再重复。</h3><h2 id="五-调试-Network-Extension："><a href="#五-调试-Network-Extension：" class="headerlink" title="五. 调试 Network Extension："></a>五. 调试 Network Extension：</h2><h3 id="调试-App-的代码很简单，但是如何调试-Extension-中的代码呢？在已经完成-PacketTunnel-的代码情况下："><a href="#调试-App-的代码很简单，但是如何调试-Extension-中的代码呢？在已经完成-PacketTunnel-的代码情况下：" class="headerlink" title="调试 App 的代码很简单，但是如何调试 Extension 中的代码呢？在已经完成 PacketTunnel 的代码情况下："></a>调试 App 的代码很简单，但是如何调试 Extension 中的代码呢？在已经完成 PacketTunnel 的代码情况下：</h3><ul>
<li>构建并运行应用。</li>
<li>停止运行。</li>
<li>Xcode 菜单中 Debug -&gt; attach to process by PID or name，填入 PacketTunnel，然后 Attach。</li>
</ul>
<p><img src="https://lettleprince.github.io/images/20171115-NetworkExtension/03.png" alt="avatar"></p>
<h2 id="六-在手机上运行（不要通过-Xcode）应用，点击连接的时候，进入了断点"><a href="#六-在手机上运行（不要通过-Xcode）应用，点击连接的时候，进入了断点" class="headerlink" title="六.在手机上运行（不要通过 Xcode）应用，点击连接的时候，进入了断点"></a>六.在手机上运行（不要通过 Xcode）应用，点击连接的时候，进入了断点</h2><p><img src="https://lettleprince.github.io/images/20171115-NetworkExtension/04.png" alt="avatar"></p>
<h2 id="文章中的代码都可以从QLadder找到。"><a href="#文章中的代码都可以从QLadder找到。" class="headerlink" title="文章中的代码都可以从QLadder找到。"></a>文章中的代码都可以从<a href="https://github.com/lettleprince/QLadder" target="_blank" rel="external">QLadder</a>找到。</h2>
      
    </div>
    
  </div>
  
    
<nav id="article-nav">
  
  
    <a href="/2019/07/19/构建 NetworkExtension 应用（一）/" id="article-nav-older" class="article-nav-link-wrap">
      <div class="article-nav-title">构建 NetworkExtension 应用（一）</div>
      <strong class="article-nav-caption">></strong>
    </a>
  
</nav>

  
</article>


<div class="share_jia">
	<!-- JiaThis Button BEGIN -->
	<div class="jiathis_style">
		<span class="jiathis_txt">Share to: &nbsp; </span>
		<a class="jiathis_button_facebook"></a> 
    <a class="jiathis_button_twitter"></a>
    <a class="jiathis_button_plus"></a> 
    <a class="jiathis_button_tsina"></a>
		<a class="jiathis_button_cqq"></a>
		<a class="jiathis_button_douban"></a>
		<a class="jiathis_button_weixin"></a>
		<a class="jiathis_button_tumblr"></a>
    <a href="http://www.jiathis.com/share" class="jiathis jiathis_txt jtico jtico_jiathis" target="_blank"></a>
	</div>
	<script type="text/javascript" src="http://v3.jiathis.com/code/jia.js?uid=1405949716054953" charset="utf-8"></script>
	<!-- JiaThis Button END -->
</div>






<div class="duoshuo">
	<!-- 多说评论框 start -->
	<div class="ds-thread" data-thread-key="构建 NetworkExtension 应用（二）" data-title="构建 NetworkExtension 应用（二）" data-url="http://yoursite.com/2019/07/20/构建 NetworkExtension 应用（二）/"></div>
	<!-- 多说评论框 end -->
	<!-- 多说公共JS代码 start (一个网页只需插入一次) -->
	<script type="text/javascript">
	var duoshuoQuery = {short_name:"true"};
	(function() {
		var ds = document.createElement('script');
		ds.type = 'text/javascript';ds.async = true;
		ds.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//static.duoshuo.com/embed.js';
		ds.charset = 'UTF-8';
		(document.getElementsByTagName('head')[0] 
		 || document.getElementsByTagName('body')[0]).appendChild(ds);
	})();
	</script>
	<!-- 多说公共JS代码 end -->
</div>




</div>
      <footer id="footer">
  <div class="outer">
    <div id="footer-info">
    	<div class="footer-left">
    		&copy; 2019 Grx
    	</div>
      	<div class="footer-right">
      		<a href="http://hexo.io/" target="_blank">Hexo</a>  Theme <a href="https://github.com/litten/hexo-theme-yilia" target="_blank">Yilia</a> by Litten
      	</div>
    </div>
  </div>
</footer>
    </div>
    
  <link rel="stylesheet" href="/fancybox/jquery.fancybox.css">


<script>
	var yiliaConfig = {
		fancybox: true,
		mathjax: true,
		animate: true,
		isHome: false,
		isPost: true,
		isArchive: false,
		isTag: false,
		isCategory: false,
		open_in_new: false
	}
</script>
<script src="http://7.url.cn/edu/jslib/comb/require-2.1.6,jquery-1.9.1.min.js"></script>
<script src="/js/main.js"></script>






<script type="text/x-mathjax-config">
MathJax.Hub.Config({
    tex2jax: {
        inlineMath: [ ['$','$'], ["\\(","\\)"]  ],
        processEscapes: true,
        skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
    }
});

MathJax.Hub.Queue(function() {
    var all = MathJax.Hub.getAllJax(), i;
    for(i=0; i < all.length; i += 1) {
        all[i].SourceElement().parentNode.className += ' has-jax';                 
    }       
});
</script>

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>


  </div>
</body>
</html>